.TH "ggiDrawVLine" 3 "2007-12-17" "libggi-current" GGI
.SH NAME
\fBggiDrawVLine\fR, \fBggiPutVLine\fR, \fBggiGetVLine\fR : Draw, put, and get a vertical line from a visual
.SH SYNOPSIS
.nb
.nf
#include <ggi/ggi.h>

int ggiDrawVLine(ggi_visual_t vis, int x, int y, int h);

int ggiPutVLine(ggi_visual_t vis, int x, int y, int h, const void *buf);

int ggiGetVLine(ggi_visual_t vis, int x, int y, int h, void *buf);
.fi

.SH DESCRIPTION
Draw, put, or get a vertical line from (\fIx\fR, \fIy\fR), extending
\fIh\fR pixels in the positive y direction (normally down). The width
of the line is one pixel.

The \fIbuf\fR parameter in Get/Put functions points to a buffer from
which the pixels will be read, or to which they will be written (it
must be correctly allocated), respectively. See
\f(CWggiPackColors(3)\fR and \f(CWggiUnmapPixel(3)\fR functions for
details on how to deal with pixels.
.SH RETURN VALUE
All three functions return \fB0\fR to indicate success.
.SH SEE ALSO
\f(CWggiDrawBox(3)\fR, \f(CWggiDrawHLine(3)\fR, \f(CWggiDrawLine(3)\fR,
\f(CWggiMapColor(3)\fR, \f(CWggi_pixelformat(3)\fR
